<html>
	<head>
		<meta charset="utf-8"></meta>
		<title>BLabel</title>
		<link href="./style.css" rel="stylesheet" type="text/css"/>
	</head>
	<body>
		<div class="class" name="BLabel">
			<h1>BLabel</h1>
			<p>继承自<a href="BWidget.html">BWidget</a></p>
			<p id="resume">BLabel是标签控件，用于显示图像和文本。<a href="#desc">详细</a></p>
			<h2>public</h2>
			<table id="public">
				<tr><td align="right"/><td><a href="#BLabel(BWidget*)">BLabel</a>(BWidget* parent = 0);</td></tr>
				<tr><td align="right"/><td><a href="#BLabel(Form,BWidget*)">BLabel</a>(Form form, BWidget* parent = 0);</td></tr>
				<tr><td align="right"/><td><a href="#BLabel(Form, const BString&,BWidget*)">BLabel</a>(Form form, const BString& text, BWidget* parent = 0);</td></tr>
				<tr><td align="right"/><td><a href="#BLabel(const BString&,BWidget*)">BLabel</a>(const BString& text, BWidget* parent = 0);</td></tr>
				<tr><td align="right"/><td><a href="#BLabel(BImage*,BWidget*)">BLabel</a>(BImage* image, BWidget* parent = 0);</td></tr>
				<tr><td align="right"/><td><a href="#BLabel(BImage*, const BString&,BWidget*)">BLabel</a>(BImage* image, const BString& text, BWidget* parent = 0);</td></tr>
				<tr><td align="right"/><td><a href="#~BLabel()">~BLabel</a>();</td></tr>
				<tr><td align="right">virtual void </td><td><a href="#copy(const BWidget*)">copy</a>(const BWidget* other);</td></tr>
				<tr><td align="right">virtual BWidget* </td><td><a href="#clone() const">clone</a>() const;</td></tr>
				<tr><td align="right">void </td><td><a href="#setForm(Form)">setForm</a>(Form form);</td></tr>
				<tr><td align="right">Form </td><td><a href="#form() const">form</a>() const;</td></tr>
				<tr><td align="right">void </td><td><a href="#setAlign(Align)">setAlign</a>(Align align);</td></tr>
				<tr><td align="right">Align </td><td><a href="#align() const">align</a>() const;</td></tr>
				<tr><td align="right">void </td><td><a href="#setSpacing(int)">setSpacing</a>(int spacing);</td></tr>
				<tr><td align="right">int </td><td><a href="#spacing() const">spacing</a>() const;</td></tr>
				<tr><td align="right">void </td><td><a href="#setColor(BByte, BByte, BByte,BByte)">setColor</a>(BByte r, BByte g, BByte b, BByte a = 255);</td></tr>
				<tr><td align="right">void </td><td><a href="#setColor(const BColor&)">setColor</a>(const BColor& color);</td></tr>
				<tr><td align="right">const BColor&amp; </td><td><a href="#color() const">color</a>() const;</td></tr>
				<tr><td align="right">void </td><td><a href="#setText(const BString&)">setText</a>(const BString& text);</td></tr>
				<tr><td align="right">const BString&amp; </td><td><a href="#text() const">text</a>() const;</td></tr>
				<tr><td align="right">void </td><td><a href="#setImage(BImage*)">setImage</a>(BImage* image);</td></tr>
				<tr><td align="right">const BImage* </td><td><a href="#image() const">image</a>() const;</td></tr>
				<tr><td align="right">BImage* </td><td><a href="#image()">image</a>();</td></tr>
				<tr><td align="right">void </td><td><a href="#setImageSize(int, int)">setImageSize</a>(int imageWidth, int imageHeight);</td></tr>
				<tr><td align="right">void </td><td><a href="#setImageSize(const BSize&)">setImageSize</a>(const BSize& imageSize);</td></tr>
				<tr><td align="right">const BSize&amp; </td><td><a href="#imageSize() const">imageSize</a>() const;</td></tr>
				<tr><td align="right">virtual BSize </td><td><a href="#sizeHint() const">sizeHint</a>() const;</td></tr>
				<tr><td align="right">virtual bool </td><td><a href="#input(const BString&, const BValue&)">input</a>(const BString& text, const BValue& value);</td></tr>
				<tr><td align="right">virtual bool </td><td><a href="#query(const BString&, BValue&) const">query</a>(const BString& text, BValue& value) const;</td></tr>
				<tr><td align="right">using </td><td><a href="#BWidget::query;()">BWidget::query;</a></td></tr>
			</table>
			<h2>protected</h2>
			<table id="protected">
				<tr><td align="right">virtual void </td><td><a href="#resizeEvent(const BEvent&)">resizeEvent</a>(const BEvent& event);</td></tr>
				<tr><td align="right">virtual void </td><td><a href="#updateEvent(const BEvent&)">updateEvent</a>(const BEvent& event);</td></tr>
				<tr><td align="right">virtual void </td><td><a href="#styleEvent(const BEvent&)">styleEvent</a>(const BEvent& event);</td></tr>
				<tr><td align="right">virtual void </td><td><a href="#freshEvent(const BEvent&)">freshEvent</a>(const BEvent& event);</td></tr>
				<tr><td align="right">virtual void </td><td><a href="#paintEvent(const BEvent&)">paintEvent</a>(const BEvent& event);</td></tr>
			</table>
			<div id="desc">
				<h2>详细介绍：</h2>
				<p>BLabel是标签控件，用于显示图像和文本。此控件常作为操作功能的说明与其它控件放在一起。</p><p>标签中设置了图像对象，还应该确保其形式（Form）是显示图像的才能显示出图像。可以设置图像的显示大小，若没有设置则以图像自身的尺寸进行适配。默认情况下形式值为Form_None，表示有什么就显示什么。</p><h5>信号：</h5><table>
					<tr><td>Signal_AlignChanged</td><td>对齐方式改变时发出，数值是Align align。</td></tr>
					<tr><td>Signal_SpacingChanged</td><td>间隔值改变时发出，数值是int spacing。</td></tr>
					<tr><td>Signal_ColorChanged</td><td>颜色改变时发出，数值是BColor color。</td></tr>
					<tr><td>Signal_TextChanged</td><td>文本内容改变时发出，数值是BString text。</td></tr>
					<tr><td>Signal_FormatChanged</td><td>文本格式对象改变时发出，数值是BTextFormat* format。</td></tr>
					<tr><td>Signal_ImageChanged</td><td>图像对象被改变时发出，数值是BImage* image。</td></tr></table>
			</div>
			<h2 id="docs">成员文档：</h2>
			<div id="BLabel(BWidget*)">
				<h3>BLabel(BWidget* parent = 0);</h3>
				<p>构造一个标签对象。parent指定其父控件。</p>
			</div>
			<div id="BLabel(Form,BWidget*)">
				<h3>BLabel(Form form, BWidget* parent = 0);</h3>
				<p>构造一个标签对象。form指定其显示形式，parent指定其父控件。</p>
			</div>
			<div id="BLabel(Form, const BString&,BWidget*)">
				<h3>BLabel(Form form, const BString&amp; text, BWidget* parent = 0);</h3>
			</div>
			<div id="BLabel(const BString&,BWidget*)">
				<h3>BLabel(const BString&amp; text, BWidget* parent = 0);</h3>
				<p>构造一个标签对象。text指定其文本，parent指定其父控件。</p>
			</div>
			<div id="BLabel(BImage*,BWidget*)">
				<h3>BLabel(BImage* image, BWidget* parent = 0);</h3>
				<p>构造一个标签对象。image指定其图像，parent指定其父控件。</p>
			</div>
			<div id="BLabel(BImage*, const BString&,BWidget*)">
				<h3>BLabel(BImage* image, const BString&amp; text, BWidget* parent = 0);</h3>
				<p>构造一个标签对象。image指定一个图像，text指定文本，parent指定其父控件。</p>
			</div>
			<div id="~BLabel()">
				<h3>~BLabel();</h3>
				<p>析构一个标签对象。</p>
			</div>
			<div id="copy(const BWidget*)">
				<h3>virtual void copy(const BWidget* other);</h3>
			</div>
			<div id="clone() const">
				<h3>virtual BWidget* clone() const;</h3>
			</div>
			<div id="setForm(Form)">
				<h3>void setForm(Form form);</h3>
				<p>设置标签的显示形式，默认值为Form_None。</p>
			</div>
			<div id="form() const">
				<h3>Form form() const;</h3>
				<p>获得标签的显示形式值。</p>
			</div>
			<div id="setAlign(Align)">
				<h3>void setAlign(Align align);</h3>
				<p>设置内容显示的对齐方式，默认为中心对齐（Align_Center）。</p>
			</div>
			<div id="align() const">
				<h3>Align align() const;</h3>
				<p>获取标签的内容显示的对齐方式。</p>
			</div>
			<div id="setSpacing(int)">
				<h3>void setSpacing(int spacing);</h3>
				<p>设置图像和文本的间隔，单位为像素值。</p>
			</div>
			<div id="spacing() const">
				<h3>int spacing() const;</h3>
				<p>获得图像与文本之间的间隔。</p>
			</div>
			<div id="setColor(BByte, BByte, BByte,BByte)">
				<h3>void setColor(BByte r, BByte g, BByte b, BByte a = 255);</h3>
				<p>设置颜色值。</p>
			</div>
			<div id="setColor(const BColor&)">
				<h3>void setColor(const BColor&amp; color);</h3>
				<p>设置颜色值。</p>
			</div>
			<div id="color() const">
				<h3>const BColor&amp; color() const;</h3>
				<p>获得颜色值。</p>
			</div>
			<div id="setText(const BString&)">
				<h3>void setText(const BString&amp; text);</h3>
				<p>设置标签的文本。</p>
			</div>
			<div id="text() const">
				<h3>const BString&amp; text() const;</h3>
				<p>取得标签的文本。</p>
			</div>
			<div id="setImage(BImage*)">
				<h3>void setImage(BImage* image);</h3>
				<p>设置标签的图像。</p>
			</div>
			<div id="image() const">
				<h3>const BImage* image() const;</h3>
				<p>获得标签的图像。</p>
			</div>
			<div id="image()">
				<h3>BImage* image();</h3>
			</div>
			<div id="setImageSize(int, int)">
				<h3>void setImageSize(int imageWidth, int imageHeight);</h3>
				<p>设置图像的显示大小，优先使用指定的大小，若没有设置则使用图像自身的尺寸。</p>
			</div>
			<div id="setImageSize(const BSize&)">
				<h3>void setImageSize(const BSize&amp; imageSize);</h3>
				<p>设置图像的显示大小，优先使用指定的大小，若没有设置则使用图像自身的尺寸。</p>
			</div>
			<div id="imageSize() const">
				<h3>const BSize&amp; imageSize() const;</h3>
				<p>获取指定的图像显示大小。</p>
			</div>
			<div id="sizeHint() const">
				<h3>virtual BSize sizeHint() const;</h3>
				<p>计算出适合的大小值。</p>
			</div>
			<div id="input(const BString&, const BValue&)">
				<h3>virtual bool input(const BString&amp; text, const BValue&amp; value);</h3>
				<p>输入表如下：</p><table>
					<tr><td>text</td><td>输入文本，值为：BString text。</td></tr>
					<tr><td>color</td><td>输入颜色，值为：BColor color。</td></tr>
					<tr><td>image</td><td>输入图像，值为：BImage* image。</td></tr>
					<tr><td>image-size</td><td>输入图像尺寸，值为：BSize imageSize。</td></tr></table>
			</div>
			<div id="query(const BString&, BValue&) const">
				<h3>virtual bool query(const BString&amp; text, BValue&amp; value) const;</h3>
				<p>查询表如下：</p><table>
					<tr><td>text</td><td>获得文本，值为：BString text。</td></tr>
					<tr><td>color</td><td>获得颜色，值为：BColor color。</td></tr>
					<tr><td>image</td><td>获得图像，值为：BImage* image。</td></tr>
					<tr><td>image-size</td><td>获得图像尺寸，值为：BSize imageSize。</td></tr>
					<tr><td>content-size</td><td>获取内容区域尺寸，数值为BSize size。</td></tr>
					<tr><td>content-rect</td><td>获得内容区域，数值为BRect rect。</td></tr>
					<tr><td>text-rect</td><td>获得文本绘制的区域，数值为BRect textRect。</td></tr>
					<tr><td>image-rect</td><td>获得图像绘制的区域，数值为BRect imageRect。</td></tr></table>
			</div>
			<div id="BWidget::query;()">
				<h3>using BWidget::query;</h3>
			</div>
			<div id="resizeEvent(const BEvent&)">
				<h3>virtual void resizeEvent(const BEvent&amp; event);</h3>
				<p>尺寸变化时将重新调整显示布局。</p>
			</div>
			<div id="updateEvent(const BEvent&)">
				<h3>virtual void updateEvent(const BEvent&amp; event);</h3>
				<p>更新事件处理。当图像为动态图时进行帧刷新。</p>
			</div>
			<div id="styleEvent(const BEvent&)">
				<h3>virtual void styleEvent(const BEvent&amp; event);</h3>
				<p>应用样式：<br/>
					<table>
						<tr><td>Value_Text</td><td>赋值为文本。</td></tr>
						<tr><td>Value_Align</td><td>赋值为对齐方式。</td></tr>
						<tr><td>Value_Color</td><td>取值为标签的颜色值。</td></tr>
						<tr><td>Value_Image</td><td>取值为标签的图像。</td></tr></table></p>
			</div>
			<div id="freshEvent(const BEvent&)">
				<h3>virtual void freshEvent(const BEvent&amp; event);</h3>
				<p>如果需要，对显示布局进行重新调整。</p>
			</div>
			<div id="paintEvent(const BEvent&)">
				<h3>virtual void paintEvent(const BEvent&amp; event);</h3>
				<p>绘制图像和文本。</p>
			</div>
		</div>
	</body>
</html>